<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GAppInfo</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GIO Reference Manual">
<link rel="up" href="types.html" title="File types and applications">
<link rel="prev" href="gio-GContentType.html" title="GContentType">
<link rel="next" href="gio-Desktop-file-based-GAppInfo.html" title="Desktop file based GAppInfo">
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="pt01.html" title="Part&#160;I.&#160;GIO Overview">
<link rel="chapter" href="ch01.html" title="Introduction">
<link rel="chapter" href="ch02.html" title="Compiling GIO applications">
<link rel="chapter" href="ch03.html" title="Running GIO applications">
<link rel="chapter" href="gio-extension-points.html" title="Extending GIO">
<link rel="part" href="pt02.html" title="Part&#160;II.&#160;API Reference">
<link rel="chapter" href="file_ops.html" title="File Operations">
<link rel="chapter" href="file_mon.html" title="File System Monitoring">
<link rel="chapter" href="async.html" title="Asynchronous I/O">
<link rel="chapter" href="streaming.html" title="Streaming I/O">
<link rel="chapter" href="types.html" title="File types and applications">
<link rel="chapter" href="volume_mon.html" title="Volumes and Drives">
<link rel="chapter" href="icons.html" title="Icons">
<link rel="chapter" href="utils.html" title="Utilities">
<link rel="chapter" href="extending.html" title="Extending GIO">
<link rel="part" href="migrating.html" title="Part&#160;III.&#160;Migrating to GIO">
<link rel="chapter" href="ch14.html" title="Migrating from POSIX to GIO">
<link rel="chapter" href="ch15.html" title="Migrating from GnomeVFS to GIO">
<link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
<link rel="index" href="ix01.html" title="Index">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gio-GContentType.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="types.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GIO Reference Manual</th>
<td><a accesskey="n" href="gio-Desktop-file-based-GAppInfo.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2791746" class="shortcut">Top</a>
                  &#160;|&#160;
                  <a href="#id2873433" class="shortcut">Description</a>
                  &#160;|&#160;
                  <a href="#id2873365" class="shortcut">Object Hierarchy</a>
                  &#160;|&#160;
                  <a href="#id2873389" class="shortcut">Prerequisites</a>
                  &#160;|&#160;
                  <a href="#id2873411" class="shortcut">Known Implementations</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GAppInfo"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2791746"></a><span class="refentrytitle">GAppInfo</span>
</h2>
<p>GAppInfo &#8212; Application information and launch contexts</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gio/gio.h&gt;


enum                <a class="link" href="GAppInfo.html#GAppInfoCreateFlags">GAppInfoCreateFlags</a>;
                    <a class="link" href="GAppInfo.html#GAppInfo-struct">GAppInfo</a>;
                    <a class="link" href="GAppInfo.html#GAppInfoIface">GAppInfoIface</a>;
                    <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a>;
<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           <a class="link" href="GAppInfo.html#g-app-info-create-from-commandline">g_app_info_create_from_commandline</a>  (const char *commandline,
                                                         const char *application_name,
                                                         <a class="link" href="GAppInfo.html#GAppInfoCreateFlags">GAppInfoCreateFlags</a> flags,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           <a class="link" href="GAppInfo.html#g-app-info-dup">g_app_info_dup</a>                      (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-equal">g_app_info_equal</a>                    (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo1,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo2);
const char*         <a class="link" href="GAppInfo.html#g-app-info-get-id">g_app_info_get_id</a>                   (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
const char*         <a class="link" href="GAppInfo.html#g-app-info-get-name">g_app_info_get_name</a>                 (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
const char*         <a class="link" href="GAppInfo.html#g-app-info-get-description">g_app_info_get_description</a>          (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
const char*         <a class="link" href="GAppInfo.html#g-app-info-get-executable">g_app_info_get_executable</a>           (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a class="link" href="GIcon.html" title="GIcon">GIcon</a>*              <a class="link" href="GAppInfo.html#g-app-info-get-icon">g_app_info_get_icon</a>                 (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-launch">g_app_info_launch</a>                   (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-supports-files">g_app_info_supports_files</a>           (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-supports-uris">g_app_info_supports_uris</a>            (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-launch-uris">g_app_info_launch_uris</a>              (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *uris,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-should-show">g_app_info_should_show</a>              (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-set-as-default-for-type">g_app_info_set_as_default_for_type</a>  (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-set-as-default-for-extension">g_app_info_set_as_default_for_extension</a>
                                                        (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *extension,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-add-supports-type">g_app_info_add_supports_type</a>        (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-can-remove-supports-type">g_app_info_can_remove_supports_type</a> (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-remove-supports-type">g_app_info_remove_supports_type</a>     (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              <a class="link" href="GAppInfo.html#g-app-info-get-all">g_app_info_get_all</a>                  (void);
<a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              <a class="link" href="GAppInfo.html#g-app-info-get-all-for-type">g_app_info_get_all_for_type</a>         (const char *content_type);
<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           <a class="link" href="GAppInfo.html#g-app-info-get-default-for-type">g_app_info_get_default_for_type</a>     (const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> must_support_uris);
<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           <a class="link" href="GAppInfo.html#g-app-info-get-default-for-uri-scheme">g_app_info_get_default_for_uri_scheme</a>
                                                        (const char *uri_scheme);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GAppInfo.html#g-app-info-launch-default-for-uri">g_app_info_launch_default_for_uri</a>   (const char *uri,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
char*               <a class="link" href="GAppInfo.html#g-app-launch-context-get-display">g_app_launch_context_get_display</a>    (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files);
char*               <a class="link" href="GAppInfo.html#g-app-launch-context-get-startup-notify-id">g_app_launch_context_get_startup_notify_id</a>
                                                        (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files);
void                <a class="link" href="GAppInfo.html#g-app-launch-context-launch-failed">g_app_launch_context_launch_failed</a>  (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         const char *startup_notify_id);
<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a>*  <a class="link" href="GAppInfo.html#g-app-launch-context-new">g_app_launch_context_new</a>            (void);


</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2873365"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">

  GInterface
   +----GAppInfo
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2873389"></a><h2>Prerequisites</h2>
<p>
GAppInfo requires
 <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2873411"></a><h2>Known Implementations</h2>
<p>
GAppInfo is implemented by
 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo">GDesktopAppInfo</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2873433"></a><h2>Description</h2>
<p>
<a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> and <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a> are used for describing and launching 
applications installed on the system.</p>
<p>

</p>
</div>
<div class="refsect1" lang="en">
<a name="id2873468"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2873479"></a><h3>
<a name="GAppInfoCreateFlags"></a>enum GAppInfoCreateFlags</h3>
<a class="indexterm" name="id2873491"></a><pre class="programlisting">typedef enum {
  G_APP_INFO_CREATE_NONE = 0,           /*&lt; nick=none &gt;*/
  G_APP_INFO_CREATE_NEEDS_TERMINAL = (1&lt;&lt;0),  /*&lt; nick=needs-terminal &gt;*/
  G_APP_INFO_CREATE_SUPPORTS_URIS = (1&lt;&lt;1)   /*&lt; nick=supports-uris &gt;*/
} GAppInfoCreateFlags;
</pre>
<p>
Flags used when creating a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-APP-INFO-CREATE-NONE:CAPS"></a><code class="literal">G_APP_INFO_CREATE_NONE</code></span></p></td>
<td> No flags.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-APP-INFO-CREATE-NEEDS-TERMINAL:CAPS"></a><code class="literal">G_APP_INFO_CREATE_NEEDS_TERMINAL</code></span></p></td>
<td> Application opens in a terminal window.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-APP-INFO-CREATE-SUPPORTS-URIS:CAPS"></a><code class="literal">G_APP_INFO_CREATE_SUPPORTS_URIS</code></span></p></td>
<td> Application supports URI arguments.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2873592"></a><h3>
<a name="GAppInfo-struct"></a>GAppInfo</h3>
<a class="indexterm" name="id2873604"></a><pre class="programlisting">typedef struct _GAppInfo GAppInfo;</pre>
<p>
Information about an installed application and methods to launch
it (with file arguments).</p>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2873625"></a><h3>
<a name="GAppInfoIface"></a>GAppInfoIface</h3>
<a class="indexterm" name="id2873637"></a><pre class="programlisting">typedef struct {
  GTypeInterface g_iface;

  /* Virtual Table */

  GAppInfo *          (*dup)                (GAppInfo                *appinfo);
  gboolean            (*equal)              (GAppInfo                *appinfo1,
					     GAppInfo                *appinfo2);
  const char *        (*get_id)             (GAppInfo                *appinfo);
  const char *        (*get_name)           (GAppInfo                *appinfo);
  const char *        (*get_description)    (GAppInfo                *appinfo);
  const char *        (*get_executable)     (GAppInfo                *appinfo);
  GIcon *             (*get_icon)           (GAppInfo                *appinfo);
  gboolean            (*launch)             (GAppInfo                *appinfo,
					     GList                   *filenames,
					     GAppLaunchContext       *launch_context,
					     GError                 **error);
  gboolean            (*supports_uris)      (GAppInfo                *appinfo);
  gboolean            (*supports_files)     (GAppInfo                *appinfo);
  gboolean            (*launch_uris)        (GAppInfo                *appinfo,
					     GList                   *uris,
					     GAppLaunchContext       *launch_context,
					     GError                 **error);
  gboolean            (*should_show)        (GAppInfo                *appinfo);

  /* For changing associations */
  gboolean  (*set_as_default_for_type)      (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);
  gboolean  (*set_as_default_for_extension) (GAppInfo           *appinfo,
					     const char         *extension,
					     GError            **error);
  gboolean  (*add_supports_type)            (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);
  gboolean  (*can_remove_supports_type)     (GAppInfo           *appinfo);
  gboolean  (*remove_supports_type)         (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);
} GAppInfoIface;
</pre>
<p>
Application Information interface, for operating system portability.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeInterface"
>GTypeInterface</a>&#160;<em class="structfield"><code>g_iface</code></em>;</span></p></td>
<td> The parent interface.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>dup</code></em>&#160;()</span></p></td>
<td> Copies a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>equal</code></em>&#160;()</span></p></td>
<td> Checks two <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>s for equality.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>get_id</code></em>&#160;()</span></p></td>
<td> Gets a string identifier for a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>get_name</code></em>&#160;()</span></p></td>
<td> Gets the name of the application for a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>get_description</code></em>&#160;()</span></p></td>
<td> Gets a short description for the application described by the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>get_executable</code></em>&#160;()</span></p></td>
<td> Gets the execuable name for the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>get_icon</code></em>&#160;()</span></p></td>
<td> Gets the <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>launch</code></em>&#160;()</span></p></td>
<td> Launches an application specified by the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>supports_uris</code></em>&#160;()</span></p></td>
<td> Indicates whether the application specified supports launching URIs.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>supports_files</code></em>&#160;()</span></p></td>
<td> Indicates whether the application specified accepts filename arguments.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>launch_uris</code></em>&#160;()</span></p></td>
<td> Launches an application with a list of URIs.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>should_show</code></em>&#160;()</span></p></td>
<td> Returns whether an application should be shown (e.g. when getting a list of installed applications).
<a class="ulink" href="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt" target="_top">
<em class="citetitle">FreeDesktop.Org Startup Notification Specification</em></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>set_as_default_for_type</code></em>&#160;()</span></p></td>
<td> Sets an application as default for a given content type.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>set_as_default_for_extension</code></em>&#160;()</span></p></td>
<td> Sets an application as default for a given file extention.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>add_supports_type</code></em>&#160;()</span></p></td>
<td> Adds to the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> information about supported file types.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>can_remove_supports_type</code></em>&#160;()</span></p></td>
<td> Checks for support for removing supported file types from a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code>remove_supports_type</code></em>&#160;()</span></p></td>
<td> Removes a supported application type from a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874076"></a><h3>
<a name="GAppLaunchContext"></a>GAppLaunchContext</h3>
<a class="indexterm" name="id2874088"></a><pre class="programlisting">typedef struct {
  GObject parent_instance;
} GAppLaunchContext;
</pre>
<p>
Integrating the launch with the launching application. This is used to
handle for instance startup notification and launching the new application
on the same screen as the launching window.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>&#160;<em class="structfield"><code>parent_instance</code></em>;</span></p></td>
<td> The parent instance.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874137"></a><h3>
<a name="g-app-info-create-from-commandline"></a>g_app_info_create_from_commandline ()</h3>
<a class="indexterm" name="id2874151"></a><pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           g_app_info_create_from_commandline  (const char *commandline,
                                                         const char *application_name,
                                                         <a class="link" href="GAppInfo.html#GAppInfoCreateFlags">GAppInfoCreateFlags</a> flags,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Creates a new <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> from the given information.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>commandline</code></em>&#160;:</span></p></td>
<td> the commandline to use
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>application_name</code></em>&#160;:</span></p></td>
<td> the application name, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use <em class="parameter"><code>commandline</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></p></td>
<td> flags that can specify details of the created <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a> location to store the error occuring, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to ignore.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> new <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for given command.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874329"></a><h3>
<a name="g-app-info-dup"></a>g_app_info_dup ()</h3>
<a class="indexterm" name="id2874342"></a><pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           g_app_info_dup                      (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Creates a duplicate of a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a duplicate of <em class="parameter"><code>appinfo</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874422"></a><h3>
<a name="g-app-info-equal"></a>g_app_info_equal ()</h3>
<a class="indexterm" name="id2874434"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_equal                    (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo1,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo2);</pre>
<p>
Checks if two <span class="type">GAppInfos</span> are equal.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo1</code></em>&#160;:</span></p></td>
<td> the first <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.  
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo2</code></em>&#160;:</span></p></td>
<td> the second <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>appinfo1</code></em> is equal to <em class="parameter"><code>appinfo2</code></em>. <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874569"></a><h3>
<a name="g-app-info-get-id"></a>g_app_info_get_id ()</h3>
<a class="indexterm" name="id2874581"></a><pre class="programlisting">const char*         g_app_info_get_id                   (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Gets the ID of an application. An id is a string that
identifies the application. The exact format of the id is
platform dependent. For instance, on Unix this is the
desktop file id from the xdg menu specification.
</p>
<p>
Note that the returned ID may be <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>, depending on how
the <em class="parameter"><code>appinfo</code></em> has been constructed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a string containing the application's ID.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874672"></a><h3>
<a name="g-app-info-get-name"></a>g_app_info_get_name ()</h3>
<a class="indexterm" name="id2874685"></a><pre class="programlisting">const char*         g_app_info_get_name                 (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Gets the installed name of the application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the name of the application for <em class="parameter"><code>appinfo</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874760"></a><h3>
<a name="g-app-info-get-description"></a>g_app_info_get_description ()</h3>
<a class="indexterm" name="id2874772"></a><pre class="programlisting">const char*         g_app_info_get_description          (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Gets a human-readable description of an installed application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a string containing a description of the 
application <em class="parameter"><code>appinfo</code></em>, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if none. 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874858"></a><h3>
<a name="g-app-info-get-executable"></a>g_app_info_get_executable ()</h3>
<a class="indexterm" name="id2874870"></a><pre class="programlisting">const char*         g_app_info_get_executable           (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Gets the executable's name for the installed application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a string containing the <em class="parameter"><code>appinfo</code></em>'s application 
binary's name.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2874945"></a><h3>
<a name="g-app-info-get-icon"></a>g_app_info_get_icon ()</h3>
<a class="indexterm" name="id2874957"></a><pre class="programlisting"><a class="link" href="GIcon.html" title="GIcon">GIcon</a>*              g_app_info_get_icon                 (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Gets the icon for the application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the default <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for <em class="parameter"><code>appinfo</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2875038"></a><h3>
<a name="g-app-info-launch"></a>g_app_info_launch ()</h3>
<a class="indexterm" name="id2875050"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_launch                   (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Launches the application. Passes <em class="parameter"><code>files</code></em> to the launched application 
as arguments, using the optional <em class="parameter"><code>launch_context</code></em> to get information
about the details of the launcher (like what screen it is on).
On error, <em class="parameter"><code>error</code></em> will be set accordingly.
</p>
<p>
To lauch the application without arguments pass a <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> <em class="parameter"><code>files</code></em> list.
</p>
<p>
Note that even if the launch is successful the application launched
can fail to start if it runs into problems during startup. There is
no way to detect this.
</p>
<p>
Some URIs can be changed when passed through a GFile (for instance
unsupported uris with strange formats like mailto:), so if you have
a textual uri you want to pass in as argument, consider using
<a class="link" href="GAppInfo.html#g-app-info-launch-uris"><code class="function">g_app_info_launch_uris()</code></a> instead.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>files</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> objects.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>launch_context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on successful launch, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise. 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2875291"></a><h3>
<a name="g-app-info-supports-files"></a>g_app_info_supports_files ()</h3>
<a class="indexterm" name="id2875303"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_supports_files           (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Checks if the application accepts files as arguments.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the <em class="parameter"><code>appinfo</code></em> supports files.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879108"></a><h3>
<a name="g-app-info-supports-uris"></a>g_app_info_supports_uris ()</h3>
<a class="indexterm" name="id2879118"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_supports_uris            (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Checks if the application supports reading files and directories from URIs.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the <em class="parameter"><code>appinfo</code></em> supports URIs.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879193"></a><h3>
<a name="g-app-info-launch-uris"></a>g_app_info_launch_uris ()</h3>
<a class="indexterm" name="id2879203"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_launch_uris              (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *uris,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Launches the application. Passes <em class="parameter"><code>uris</code></em> to the launched application 
as arguments, using the optional <em class="parameter"><code>launch_context</code></em> to get information
about the details of the launcher (like what screen it is on).
On error, <em class="parameter"><code>error</code></em> will be set accordingly.
</p>
<p>
To lauch the application without arguments pass a <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> <em class="parameter"><code>uris</code></em> list.
</p>
<p>
Note that even if the launch is successful the application launched
can fail to start if it runs into problems during startup. There is
no way to detect this.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uris</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> containing URIs to launch. 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>launch_context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on successful launch, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise. 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879399"></a><h3>
<a name="g-app-info-should-show"></a>g_app_info_should_show ()</h3>
<a class="indexterm" name="id2879410"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_should_show              (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Checks if the application info should be shown in menus that 
list available applications.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the <em class="parameter"><code>appinfo</code></em> should be shown, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879493"></a><h3>
<a name="g-app-info-set-as-default-for-type"></a>g_app_info_set_as_default_for_type ()</h3>
<a class="indexterm" name="id2879506"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_set_as_default_for_type  (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Sets the application as the default handler for a given type.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>content_type</code></em>&#160;:</span></p></td>
<td> the content type.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on success, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879628"></a><h3>
<a name="g-app-info-set-as-default-for-extension"></a>g_app_info_set_as_default_for_extension ()</h3>
<a class="indexterm" name="id2879641"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_set_as_default_for_extension
                                                        (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *extension,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Sets the application as the default handler for the given file extention.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></p></td>
<td> a string containing the file extension (without the dot).
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on success, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879766"></a><h3>
<a name="g-app-info-add-supports-type"></a>g_app_info_add_supports_type ()</h3>
<a class="indexterm" name="id2879778"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_add_supports_type        (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Adds a content type to the application information to indicate the 
application is capable of opening files with the given content type.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>content_type</code></em>&#160;:</span></p></td>
<td> a string.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on success, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2879902"></a><h3>
<a name="g-app-info-can-remove-supports-type"></a>g_app_info_can_remove_supports_type ()</h3>
<a class="indexterm" name="id2879916"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_can_remove_supports_type (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo);</pre>
<p>
Checks if a supported content type can be removed from an application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if it is possible to remove supported 
    content types from a given <em class="parameter"><code>appinfo</code></em>, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880000"></a><h3>
<a name="g-app-info-remove-supports-type"></a>g_app_info_remove_supports_type ()</h3>
<a class="indexterm" name="id2880012"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_remove_supports_type     (<a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *appinfo,
                                                         const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Removes a supported type from an application, if possible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>appinfo</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>content_type</code></em>&#160;:</span></p></td>
<td> a string.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on success, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880135"></a><h3>
<a name="g-app-info-get-all"></a>g_app_info_get_all ()</h3>
<a class="indexterm" name="id2880145"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              g_app_info_get_all                  (void);</pre>
<p>
Gets a list of all of the applications currently registered 
on this system.
</p>
<p>
For desktop files, this includes applications that have 
<code class="literal">NoDisplay=true</code> set or are excluded from 
display by means of <code class="literal">OnlyShowIn</code> or
<code class="literal">NotShowIn</code>. See <a class="link" href="GAppInfo.html#g-app-info-should-show"><code class="function">g_app_info_should_show()</code></a>.
The returned list does not include applications which have
the <code class="literal">Hidden</code> key set.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly allocated <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of references to <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>s.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880232"></a><h3>
<a name="g-app-info-get-all-for-type"></a>g_app_info_get_all_for_type ()</h3>
<a class="indexterm" name="id2880243"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              g_app_info_get_all_for_type         (const char *content_type);</pre>
<p>
Gets a list of all <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> s for a given content type.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>content_type</code></em>&#160;:</span></p></td>
<td> the content type to find a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> s for given <em class="parameter"><code>content_type</code></em>
   or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880336"></a><h3>
<a name="g-app-info-get-default-for-type"></a>g_app_info_get_default_for_type ()</h3>
<a class="indexterm" name="id2880348"></a><pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           g_app_info_get_default_for_type     (const char *content_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> must_support_uris);</pre>
<p>
Gets the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> that correspond to a given content type.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>content_type</code></em>&#160;:</span></p></td>
<td> the content type to find a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>must_support_uris</code></em>&#160;:</span></p></td>
<td> if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> is expected to
    support URIs
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for given <em class="parameter"><code>content_type</code></em> or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880471"></a><h3>
<a name="g-app-info-get-default-for-uri-scheme"></a>g_app_info_get_default_for_uri_scheme ()</h3>
<a class="indexterm" name="id2880484"></a><pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>*           g_app_info_get_default_for_uri_scheme
                                                        (const char *uri_scheme);</pre>
<p>
Gets the default application for launching applications 
using this URI scheme. A URI scheme is the initial part 
of the URI, up to but not including the ':', e.g. "http", 
"ftp" or "sip".</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri_scheme</code></em>&#160;:</span></p></td>
<td> a string containing a URI scheme.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for given <em class="parameter"><code>uri_scheme</code></em> or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880563"></a><h3>
<a name="g-app-info-launch-default-for-uri"></a>g_app_info_launch_default_for_uri ()</h3>
<a class="indexterm" name="id2880576"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            g_app_info_launch_default_for_uri   (const char *uri,
                                                         <a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *launch_context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Utility function that launches the default application 
registered to handle the specified uri. Synchronous I/O
is done on the uri to detext the type of the file if
required.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td> the uri to show
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>launch_context</code></em>&#160;:</span></p></td>
<td> an optional <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> on success, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on error.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880700"></a><h3>
<a name="g-app-launch-context-get-display"></a>g_app_launch_context_get_display ()</h3>
<a class="indexterm" name="id2880712"></a><pre class="programlisting">char*               g_app_launch_context_get_display    (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files);</pre>
<p>
Gets the display string for the display. This is used to ensure new
applications are started on the same display as the launching 
application.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.  
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>. 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>files</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of files.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a display string for the display.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880827"></a><h3>
<a name="g-app-launch-context-get-startup-notify-id"></a>g_app_launch_context_get_startup_notify_id ()</h3>
<a class="indexterm" name="id2880841"></a><pre class="programlisting">char*               g_app_launch_context_get_startup_notify_id
                                                        (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *files);</pre>
<p>
Initiates startup notification for the applicaiont and returns the
DESKTOP_STARTUP_ID for the launched operation, if supported.
</p>
<p>
Startup notification IDs are defined in the FreeDesktop.Org Startup 
Notifications standard, at 
<a class="ulink" href="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt" target="_top">http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt</a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>files</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of files.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a startup notification ID for the application, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if 
    not supported.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2880974"></a><h3>
<a name="g-app-launch-context-launch-failed"></a>g_app_launch_context_launch_failed ()</h3>
<a class="indexterm" name="id2880988"></a><pre class="programlisting">void                g_app_launch_context_launch_failed  (<a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a> *context,
                                                         const char *startup_notify_id);</pre>
<p>
Called when an application has failed to launch, so that it can cancel
the application startup notification started in <a class="link" href="GAppInfo.html#g-app-launch-context-get-startup-notify-id"><code class="function">g_app_launch_context_get_startup_notify_id()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>startup_notify_id</code></em>&#160;:</span></p></td>
<td> the startup notification id that was returned by <a class="link" href="GAppInfo.html#g-app-launch-context-get-startup-notify-id"><code class="function">g_app_launch_context_get_startup_notify_id()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2881080"></a><h3>
<a name="g-app-launch-context-new"></a>g_app_launch_context_new ()</h3>
<a class="indexterm" name="id2881091"></a><pre class="programlisting"><a class="link" href="GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a>*  g_app_launch_context_new            (void);</pre>
<p>
Creates a new application launch context. This is not normally used,
instead you instantiate a subclass of this, such as <span class="type">GdkAppLaunchContext</span>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2881142"></a><div class="refsect2" lang="en"><a name="id2881143"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id2881144"></a></div>
</div>
</div>
</body>
</html>
